home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 2010 April / PCWorld0410.iso / hity wydania / Ubuntu 9.10 PL / karmelkowy-koliberek-desktop-9.10-i386-PL.iso / casper / filesystem.squashfs / usr / share / snmp / mibs / BRIDGE-MIB.txt < prev    next >
Text File  |  2009-10-02  |  37KB  |  1,076 lines
  1. BRIDGE-MIB DEFINITIONS ::= BEGIN
  2.  
  3. IMPORTS
  4.            Counter, TimeTicks
  5.                    FROM RFC1155-SMI
  6.            mib-2
  7.                    FROM RFC1213-MIB
  8.            OBJECT-TYPE
  9.                    FROM RFC-1212
  10.            TRAP-TYPE
  11.                    FROM RFC-1215;
  12.  
  13. -- All representations of MAC addresses in this MIB Module
  14. -- use, as a textual convention (i.e. this convention does
  15. -- not affect their encoding), the data type:
  16. MacAddress ::= OCTET STRING (SIZE (6))    -- a 6 octet address
  17.                                           -- in the
  18.                                           -- "canonical"
  19.                                           -- order
  20. -- defined by IEEE 802.1a, i.e., as if it were transmitted
  21. -- least significant bit first, even though 802.5 (in
  22. -- contrast to other n802.x protocols) requires MAC
  23. -- addresses to be transmitted most significant bit first.
  24. --
  25. -- 16-bit addresses, if needed, are represented by setting
  26. -- their upper 4 octets to all 0's, i.e., AAFF would be
  27. -- represented as 00000000AAFF.
  28.  
  29. -- Similarly, all representations of Bridge-Id in this MIB
  30. -- Module use, as a textual convention (i.e. this
  31. -- convention does not affect their encoding), the data
  32. -- type:
  33. BridgeId ::= OCTET STRING (SIZE (8))   -- the
  34.                                        -- Bridge-Identifier
  35.                                        -- as used in the
  36.                                        -- Spanning Tree
  37. -- Protocol to uniquely identify a bridge.  Its first two
  38. -- octets (in network byte order) contain a priority
  39. -- value and its last 6 octets contain the MAC address
  40. -- used to refer to a bridge in a unique fashion
  41. -- (typically, the numerically smallest MAC address
  42. -- of all ports on the bridge).
  43.  
  44. -- Several objects in this MIB module represent values of
  45. -- timers used by the Spanning Tree Protocol.  In this
  46. -- MIB, these timers have values in units of hundreths of
  47. -- a second (i.e. 1/100 secs).
  48. -- These timers, when stored in a Spanning Tree Protocol's
  49. -- BPDU, are in units of 1/256 seconds.  Note, however,
  50. -- that 802.1D-1990 specifies a settable granularity of
  51. -- no more than 1 second for these timers.  To avoid
  52. -- ambiguity, a data type is defined here as a textual
  53. -- convention and all representation of these timers
  54. -- in this MIB module are defined using this data type.  An
  55. -- algorithm is also defined for converting between the
  56. -- different units, to ensure a timer's value is not
  57. -- distorted by multiple conversions.
  58. -- The data type is:
  59.  
  60. Timeout ::= INTEGER -- a STP timer in units of 1/100 seconds
  61.  
  62. -- To convert a Timeout value into a value in units of
  63. -- 1/256 seconds, the following algorithm should be used:
  64. --
  65. --      b  = floor( (n * 256) / 100)
  66. --
  67. -- where:
  68. --      floor   =  quotient [ignore remainder]
  69. --      n is the value in 1/100 second units
  70. --      b is the value in 1/256 second units
  71. --
  72. -- To convert the value from 1/256 second units back to
  73. -- 1/100 seconds, the following algorithm should be used:
  74. --
  75. --      n = ceiling( (b * 100) / 256)
  76. --
  77. -- where:
  78. --      ceiling =  quotient [if remainder is 0], or
  79. --                 quotient + 1 [if remainder is non-zero]
  80. --      n is the value in 1/100 second units
  81. --      b is the value in 1/256 second units
  82. --
  83. -- Note: it is important that the arithmetic operations are
  84. -- done in the order specified (i.e., multiply first, divide
  85. -- second).
  86.  
  87.    dot1dBridge   OBJECT IDENTIFIER ::= { mib-2 17 }
  88.  
  89. -- groups in the Bridge MIB
  90.  
  91. dot1dBase     OBJECT IDENTIFIER ::= { dot1dBridge 1 }
  92.  
  93. dot1dStp      OBJECT IDENTIFIER ::= { dot1dBridge 2 }
  94.  
  95. dot1dSr       OBJECT IDENTIFIER ::= { dot1dBridge 3 }
  96. -- separately documented
  97.  
  98. dot1dTp       OBJECT IDENTIFIER ::= { dot1dBridge 4 }
  99.  
  100. dot1dStatic   OBJECT IDENTIFIER ::= { dot1dBridge 5 }
  101.  
  102. -- the dot1dBase group
  103.  
  104. -- Implementation of the dot1dBase group is mandatory for all
  105. -- bridges.
  106.  
  107. dot1dBaseBridgeAddress OBJECT-TYPE
  108.     SYNTAX  MacAddress
  109.     ACCESS  read-only
  110.     STATUS  mandatory
  111.     DESCRIPTION
  112.             "The MAC address used by this bridge when it must
  113.             be referred to in a unique fashion.   It is
  114.             recommended that this be the numerically smallest
  115.             MAC address of all ports that belong to this
  116.             bridge.  However it is only required to be unique.
  117.             When concatenated with dot1dStpPriority a unique
  118.             BridgeIdentifier is formed which is used in the
  119.             Spanning Tree Protocol."
  120.     REFERENCE
  121.             "IEEE 802.1D-1990: Sections 6.4.1.1.3 and 3.12.5"
  122.     ::= { dot1dBase 1 }
  123.  
  124. dot1dBaseNumPorts OBJECT-TYPE
  125.     SYNTAX  INTEGER
  126.     ACCESS  read-only
  127.     STATUS  mandatory
  128.     DESCRIPTION
  129.             "The number of ports controlled by this bridging
  130.             entity."
  131.     REFERENCE
  132.             "IEEE 802.1D-1990: Section 6.4.1.1.3"
  133.     ::= { dot1dBase 2 }
  134.  
  135. dot1dBaseType OBJECT-TYPE
  136.     SYNTAX  INTEGER {
  137.                 unknown(1),
  138.                 transparent-only(2),
  139.                 sourceroute-only(3),
  140.                 srt(4)
  141.             }
  142.     ACCESS  read-only
  143.     STATUS  mandatory
  144.     DESCRIPTION
  145.             "Indicates what type of bridging this bridge can
  146.             perform.  If a bridge is actually performing a
  147.             certain type of bridging this will be indicated by
  148.             entries in the port table for the given type."
  149.     ::= { dot1dBase 3 }
  150.  
  151. -- The Generic Bridge Port Table
  152.  
  153. dot1dBasePortTable OBJECT-TYPE
  154.     SYNTAX  SEQUENCE OF Dot1dBasePortEntry
  155.     ACCESS  not-accessible
  156.     STATUS  mandatory
  157.     DESCRIPTION
  158.             "A table that contains generic information about
  159.             every port that is associated with this bridge.
  160.             Transparent, source-route, and srt ports are
  161.             included."
  162.     ::= { dot1dBase 4 }
  163.  
  164. dot1dBasePortEntry OBJECT-TYPE
  165.     SYNTAX  Dot1dBasePortEntry
  166.     ACCESS  not-accessible
  167.     STATUS  mandatory
  168.     DESCRIPTION
  169.             "A list of information for each port of the
  170.             bridge."
  171.     REFERENCE
  172.             "IEEE 802.1D-1990: Section 6.4.2, 6.6.1"
  173.     INDEX  { dot1dBasePort }
  174.     ::= { dot1dBasePortTable 1 }
  175.  
  176. Dot1dBasePortEntry ::=
  177.     SEQUENCE {
  178.         dot1dBasePort
  179.             INTEGER,
  180.         dot1dBasePortIfIndex
  181.             INTEGER,
  182.         dot1dBasePortCircuit
  183.  
  184.             OBJECT IDENTIFIER,
  185.         dot1dBasePortDelayExceededDiscards
  186.             Counter,
  187.         dot1dBasePortMtuExceededDiscards
  188.             Counter
  189.     }
  190.  
  191. dot1dBasePort OBJECT-TYPE
  192.     SYNTAX  INTEGER (1..65535)
  193.     ACCESS  read-only
  194.     STATUS  mandatory
  195.     DESCRIPTION
  196.             "The port number of the port for which this entry
  197.             contains bridge management information."
  198.     ::= { dot1dBasePortEntry 1 }
  199.  
  200. dot1dBasePortIfIndex OBJECT-TYPE
  201.     SYNTAX  INTEGER
  202.     ACCESS  read-only
  203.     STATUS  mandatory
  204.     DESCRIPTION
  205.             "The value of the instance of the ifIndex object,
  206.             defined in MIB-II, for the interface corresponding
  207.             to this port."
  208.     ::= { dot1dBasePortEntry 2 }
  209.  
  210. dot1dBasePortCircuit OBJECT-TYPE
  211.     SYNTAX  OBJECT IDENTIFIER
  212.     ACCESS  read-only
  213.     STATUS  mandatory
  214.     DESCRIPTION
  215.             "For a port which (potentially) has the same value
  216.             of dot1dBasePortIfIndex as another port on the
  217.             same bridge, this object contains the name of an
  218.             object instance unique to this port.  For example,
  219.             in the case where multiple ports correspond one-
  220.             to-one with multiple X.25 virtual circuits, this
  221.             value might identify an (e.g., the first) object
  222.             instance associated with the X.25 virtual circuit
  223.             corresponding to this port.
  224.  
  225.             For a port which has a unique value of
  226.             dot1dBasePortIfIndex, this object can have the
  227.             value { 0 0 }."
  228.     ::= { dot1dBasePortEntry 3 }
  229.  
  230. dot1dBasePortDelayExceededDiscards OBJECT-TYPE
  231.     SYNTAX  Counter
  232.  
  233.     ACCESS  read-only
  234.     STATUS  mandatory
  235.     DESCRIPTION
  236.             "The number of frames discarded by this port due
  237.             to excessive transit delay through the bridge.  It
  238.             is incremented by both transparent and source
  239.             route bridges."
  240.     REFERENCE
  241.              "IEEE 802.1D-1990: Section 6.6.1.1.3"
  242.     ::= { dot1dBasePortEntry 4 }
  243.  
  244. dot1dBasePortMtuExceededDiscards OBJECT-TYPE
  245.     SYNTAX  Counter
  246.     ACCESS  read-only
  247.     STATUS  mandatory
  248.     DESCRIPTION
  249.             "The number of frames discarded by this port due
  250.             to an excessive size.  It is incremented by both
  251.             transparent and source route bridges."
  252.     REFERENCE
  253.             "IEEE 802.1D-1990: Section 6.6.1.1.3"
  254.     ::= { dot1dBasePortEntry 5 }
  255.  
  256. -- the dot1dStp group
  257.  
  258. -- Implementation of the dot1dStp group is optional.  It is
  259. -- implemented by those bridges that support the Spanning Tree
  260. -- Protocol.
  261.  
  262. dot1dStpProtocolSpecification OBJECT-TYPE
  263.     SYNTAX  INTEGER {
  264.                 unknown(1),
  265.                 decLb100(2),
  266.                 ieee8021d(3)
  267.             }
  268.     ACCESS  read-only
  269.     STATUS  mandatory
  270.     DESCRIPTION
  271.             "An indication of what version of the Spanning
  272.             Tree Protocol is being run.  The value
  273.             'decLb100(2)' indicates the DEC LANbridge 100
  274.             Spanning Tree protocol.  IEEE 802.1d
  275.             implementations will return 'ieee8021d(3)'.  If
  276.             future versions of the IEEE Spanning Tree Protocol
  277.             are released that are incompatible with the
  278.             current version a new value will be defined."
  279.  
  280.     ::= { dot1dStp 1 }
  281.  
  282. dot1dStpPriority OBJECT-TYPE
  283.     SYNTAX  INTEGER (0..65535)
  284.     ACCESS  read-write
  285.     STATUS  mandatory
  286.     DESCRIPTION
  287.             "The value of the write-able portion of the Bridge
  288.             ID, i.e., the first two octets of the (8 octet
  289.             long) Bridge ID.  The other (last) 6 octets of the
  290.             Bridge ID are given by the value of
  291.             dot1dBaseBridgeAddress."
  292.     REFERENCE
  293.             "IEEE 802.1D-1990: Section 4.5.3.7"
  294.     ::= { dot1dStp 2 }
  295.  
  296. dot1dStpTimeSinceTopologyChange OBJECT-TYPE
  297.     SYNTAX  TimeTicks
  298.     ACCESS  read-only
  299.     STATUS  mandatory
  300.     DESCRIPTION
  301.             "The time (in hundredths of a second) since the
  302.             last time a topology change was detected by the
  303.             bridge entity."
  304.     REFERENCE
  305.             "IEEE 802.1D-1990: Section 6.8.1.1.3"
  306.     ::= { dot1dStp 3 }
  307.  
  308. dot1dStpTopChanges OBJECT-TYPE
  309.     SYNTAX  Counter
  310.     ACCESS  read-only
  311.     STATUS  mandatory
  312.     DESCRIPTION
  313.             "The total number of topology changes detected by
  314.             this bridge since the management entity was last
  315.             reset or initialized."
  316.     REFERENCE
  317.             "IEEE 802.1D-1990: Section 6.8.1.1.3"
  318.     ::= { dot1dStp 4 }
  319.  
  320. dot1dStpDesignatedRoot OBJECT-TYPE
  321.     SYNTAX  BridgeId
  322.     ACCESS  read-only
  323.     STATUS  mandatory
  324.     DESCRIPTION
  325.             "The bridge identifier of the root of the spanning
  326.             tree as determined by the Spanning Tree Protocol
  327.             as executed by this node.  This value is used as
  328.  
  329.             the Root Identifier parameter in all Configuration
  330.             Bridge PDUs originated by this node."
  331.     REFERENCE
  332.             "IEEE 802.1D-1990: Section 4.5.3.1"
  333.     ::= { dot1dStp 5 }
  334.  
  335. dot1dStpRootCost OBJECT-TYPE
  336.     SYNTAX  INTEGER
  337.     ACCESS  read-only
  338.     STATUS  mandatory
  339.     DESCRIPTION
  340.             "The cost of the path to the root as seen from
  341.             this bridge."
  342.     REFERENCE
  343.             "IEEE 802.1D-1990: Section 4.5.3.2"
  344.     ::= { dot1dStp 6 }
  345.  
  346. dot1dStpRootPort OBJECT-TYPE
  347.     SYNTAX  INTEGER
  348.     ACCESS  read-only
  349.     STATUS  mandatory
  350.     DESCRIPTION
  351.             "The port number of the port which offers the
  352.             lowest cost path from this bridge to the root
  353.             bridge."
  354.     REFERENCE
  355.             "IEEE 802.1D-1990: Section 4.5.3.3"
  356.     ::= { dot1dStp 7 }
  357.  
  358. dot1dStpMaxAge OBJECT-TYPE
  359.     SYNTAX  Timeout
  360.     ACCESS  read-only
  361.     STATUS  mandatory
  362.     DESCRIPTION
  363.             "The maximum age of Spanning Tree Protocol
  364.             information learned from the network on any port
  365.             before it is discarded, in units of hundredths of
  366.             a second.  This is the actual value that this
  367.             bridge is currently using."
  368.     REFERENCE
  369.             "IEEE 802.1D-1990: Section 4.5.3.4"
  370.     ::= { dot1dStp 8 }
  371.  
  372. dot1dStpHelloTime OBJECT-TYPE
  373.     SYNTAX  Timeout
  374.     ACCESS  read-only
  375.     STATUS  mandatory
  376.     DESCRIPTION
  377.  
  378.             "The amount of time between the transmission of
  379.             Configuration bridge PDUs by this node on any port
  380.             when it is the root of the spanning tree or trying
  381.             to become so, in units of hundredths of a second.
  382.             This is the actual value that this bridge is
  383.             currently using."
  384.     REFERENCE
  385.             "IEEE 802.1D-1990: Section 4.5.3.5"
  386.     ::= { dot1dStp 9 }
  387.  
  388. dot1dStpHoldTime OBJECT-TYPE
  389.     SYNTAX  INTEGER
  390.     ACCESS  read-only
  391.     STATUS  mandatory
  392.     DESCRIPTION
  393.             "This time value determines the interval length
  394.             during which no more than two Configuration bridge
  395.             PDUs shall be transmitted by this node, in units
  396.             of hundredths of a second."
  397.     REFERENCE
  398.             "IEEE 802.1D-1990: Section 4.5.3.14"
  399.     ::= { dot1dStp 10 }
  400.  
  401. dot1dStpForwardDelay OBJECT-TYPE
  402.     SYNTAX  Timeout
  403.     ACCESS  read-only
  404.     STATUS  mandatory
  405.     DESCRIPTION
  406.             "This time value, measured in units of hundredths
  407.             of a second, controls how fast a port changes its
  408.             spanning state when moving towards the Forwarding
  409.             state.  The value determines how long the port
  410.             stays in each of the Listening and Learning
  411.             states, which precede the Forwarding state.  This
  412.             value is also used, when a topology change has
  413.             been detected and is underway, to age all dynamic
  414.             entries in the Forwarding Database.  [Note that
  415.             this value is the one that this bridge is
  416.             currently using, in contrast to
  417.             dot1dStpBridgeForwardDelay which is the value that
  418.             this bridge and all others would start using
  419.             if/when this bridge were to become the root.]"
  420.     REFERENCE
  421.             "IEEE 802.1D-1990: Section 4.5.3.6"
  422.     ::= { dot1dStp 11 }
  423.  
  424. dot1dStpBridgeMaxAge OBJECT-TYPE
  425.     SYNTAX  Timeout (600..4000)
  426.  
  427.     ACCESS  read-write
  428.     STATUS  mandatory
  429.     DESCRIPTION
  430.             "The value that all bridges use for MaxAge when
  431.             this bridge is acting as the root.  Note that
  432.             802.1D-1990 specifies that the range for this
  433.             parameter is related to the value of
  434.             dot1dStpBridgeHelloTime. The granularity of this
  435.             timer is specified by 802.1D-1990 to be 1 second.
  436.             An agent may return a badValue error if a set is
  437.             attempted to a value which is not a whole number
  438.             of seconds."
  439.     REFERENCE
  440.             "IEEE 802.1D-1990: Section 4.5.3.8"
  441.     ::= { dot1dStp 12 }
  442.  
  443. dot1dStpBridgeHelloTime OBJECT-TYPE
  444.     SYNTAX  Timeout (100..1000)
  445.     ACCESS  read-write
  446.     STATUS  mandatory
  447.     DESCRIPTION
  448.             "The value that all bridges use for HelloTime when
  449.             this bridge is acting as the root.  The
  450.             granularity of this timer is specified by 802.1D-
  451.             1990 to be 1 second.  An agent may return a
  452.             badValue error if a set is attempted to a value
  453.             which is not a whole number of seconds."
  454.     REFERENCE
  455.             "IEEE 802.1D-1990: Section 4.5.3.9"
  456.     ::= { dot1dStp 13 }
  457.  
  458. dot1dStpBridgeForwardDelay OBJECT-TYPE
  459.     SYNTAX  Timeout (400..3000)
  460.     ACCESS  read-write
  461.     STATUS  mandatory
  462.     DESCRIPTION
  463.             "The value that all bridges use for ForwardDelay
  464.             when this bridge is acting as the root.  Note that
  465.             802.1D-1990 specifies that the range for this
  466.             parameter is related to the value of
  467.             dot1dStpBridgeMaxAge.  The granularity of this
  468.             timer is specified by 802.1D-1990 to be 1 second.
  469.             An agent may return a badValue error if a set is
  470.             attempted to a value which is not a whole number
  471.             of seconds."
  472.     REFERENCE
  473.             "IEEE 802.1D-1990: Section 4.5.3.10"
  474.     ::= { dot1dStp 14 }
  475.  
  476. -- The Spanning Tree Port Table
  477.  
  478. dot1dStpPortTable OBJECT-TYPE
  479.     SYNTAX  SEQUENCE OF Dot1dStpPortEntry
  480.     ACCESS  not-accessible
  481.     STATUS  mandatory
  482.     DESCRIPTION
  483.             "A table that contains port-specific information
  484.             for the Spanning Tree Protocol."
  485.     ::= { dot1dStp 15 }
  486.  
  487. dot1dStpPortEntry OBJECT-TYPE
  488.     SYNTAX  Dot1dStpPortEntry
  489.     ACCESS  not-accessible
  490.     STATUS  mandatory
  491.     DESCRIPTION
  492.             "A list of information maintained by every port
  493.             about the Spanning Tree Protocol state for that
  494.             port."
  495.     INDEX   { dot1dStpPort }
  496.     ::= { dot1dStpPortTable 1 }
  497.  
  498. Dot1dStpPortEntry ::=
  499.     SEQUENCE {
  500.         dot1dStpPort
  501.             INTEGER,
  502.         dot1dStpPortPriority
  503.             INTEGER,
  504.         dot1dStpPortState
  505.             INTEGER,
  506.         dot1dStpPortEnable
  507.             INTEGER,
  508.         dot1dStpPortPathCost
  509.             INTEGER,
  510.         dot1dStpPortDesignatedRoot
  511.             BridgeId,
  512.         dot1dStpPortDesignatedCost
  513.             INTEGER,
  514.         dot1dStpPortDesignatedBridge
  515.             BridgeId,
  516.         dot1dStpPortDesignatedPort
  517.             OCTET STRING,
  518.         dot1dStpPortForwardTransitions
  519.             Counter
  520.     }
  521.  
  522. dot1dStpPort OBJECT-TYPE
  523.     SYNTAX  INTEGER (1..65535)
  524.  
  525.     ACCESS  read-only
  526.     STATUS  mandatory
  527.     DESCRIPTION
  528.             "The port number of the port for which this entry
  529.             contains Spanning Tree Protocol management
  530.             information."
  531.     REFERENCE
  532.             "IEEE 802.1D-1990: Section 6.8.2.1.2"
  533.     ::= { dot1dStpPortEntry 1 }
  534.  
  535. dot1dStpPortPriority OBJECT-TYPE
  536.     SYNTAX  INTEGER (0..255)
  537.     ACCESS  read-write
  538.     STATUS  mandatory
  539.     DESCRIPTION
  540.             "The value of the priority field which is
  541.             contained in the first (in network byte order)
  542.             octet of the (2 octet long) Port ID.  The other
  543.             octet of the Port ID is given by the value of
  544.             dot1dStpPort."
  545.     REFERENCE
  546.             "IEEE 802.1D-1990: Section 4.5.5.1"
  547.     ::= { dot1dStpPortEntry 2 }
  548.  
  549. dot1dStpPortState OBJECT-TYPE
  550.     SYNTAX  INTEGER {
  551.                 disabled(1),
  552.                 blocking(2),
  553.                 listening(3),
  554.                 learning(4),
  555.                 forwarding(5),
  556.                 broken(6)
  557.             }
  558.     ACCESS  read-only
  559.     STATUS  mandatory
  560.     DESCRIPTION
  561.             "The port's current state as defined by
  562.             application of the Spanning Tree Protocol.  This
  563.             state controls what action a port takes on
  564.             reception of a frame.  If the bridge has detected
  565.             a port that is malfunctioning it will place that
  566.             port into the broken(6) state.  For ports which
  567.             are disabled (see dot1dStpPortEnable), this object
  568.             will have a value of disabled(1)."
  569.     REFERENCE
  570.             "IEEE 802.1D-1990: Section 4.5.5.2"
  571.     ::= { dot1dStpPortEntry 3 }
  572.  
  573. dot1dStpPortEnable OBJECT-TYPE
  574.     SYNTAX  INTEGER {
  575.                 enabled(1),
  576.                 disabled(2)
  577.             }
  578.     ACCESS  read-write
  579.     STATUS  mandatory
  580.     DESCRIPTION
  581.             "The enabled/disabled status of the port."
  582.     REFERENCE
  583.             "IEEE 802.1D-1990: Section 4.5.5.2"
  584.     ::= { dot1dStpPortEntry 4 }
  585.  
  586. dot1dStpPortPathCost OBJECT-TYPE
  587.     SYNTAX  INTEGER (1..65535)
  588.     ACCESS  read-write
  589.     STATUS  mandatory
  590.     DESCRIPTION
  591.             "The contribution of this port to the path cost of
  592.             paths towards the spanning tree root which include
  593.             this port.  802.1D-1990 recommends that the
  594.             default value of this parameter be in inverse
  595.             proportion to the speed of the attached LAN."
  596.     REFERENCE
  597.             "IEEE 802.1D-1990: Section 4.5.5.3"
  598.     ::= { dot1dStpPortEntry 5 }
  599.  
  600. dot1dStpPortDesignatedRoot OBJECT-TYPE
  601.     SYNTAX  BridgeId
  602.     ACCESS  read-only
  603.     STATUS  mandatory
  604.     DESCRIPTION
  605.             "The unique Bridge Identifier of the Bridge
  606.             recorded as the Root in the Configuration BPDUs
  607.             transmitted by the Designated Bridge for the
  608.             segment to which the port is attached."
  609.     REFERENCE
  610.             "IEEE 802.1D-1990: Section 4.5.5.4"
  611.     ::= { dot1dStpPortEntry 6 }
  612.  
  613. dot1dStpPortDesignatedCost OBJECT-TYPE
  614.     SYNTAX  INTEGER
  615.     ACCESS  read-only
  616.     STATUS  mandatory
  617.     DESCRIPTION
  618.             "The path cost of the Designated Port of the
  619.             segment connected to this port.  This value is
  620.             compared to the Root Path Cost field in received
  621.  
  622.             bridge PDUs."
  623.     REFERENCE
  624.             "IEEE 802.1D-1990: Section 4.5.5.5"
  625.     ::= { dot1dStpPortEntry 7 }
  626.  
  627. dot1dStpPortDesignatedBridge OBJECT-TYPE
  628.     SYNTAX  BridgeId
  629.     ACCESS  read-only
  630.     STATUS  mandatory
  631.     DESCRIPTION
  632.             "The Bridge Identifier of the bridge which this
  633.             port considers to be the Designated Bridge for
  634.             this port's segment."
  635.     REFERENCE
  636.             "IEEE 802.1D-1990: Section 4.5.5.6"
  637.     ::= { dot1dStpPortEntry 8 }
  638.  
  639. dot1dStpPortDesignatedPort OBJECT-TYPE
  640.     SYNTAX  OCTET STRING (SIZE (2))
  641.     ACCESS  read-only
  642.     STATUS  mandatory
  643.     DESCRIPTION
  644.             "The Port Identifier of the port on the Designated
  645.             Bridge for this port's segment."
  646.     REFERENCE
  647.             "IEEE 802.1D-1990: Section 4.5.5.7"
  648.     ::= { dot1dStpPortEntry 9 }
  649.  
  650. dot1dStpPortForwardTransitions OBJECT-TYPE
  651.     SYNTAX  Counter
  652.     ACCESS  read-only
  653.     STATUS  mandatory
  654.     DESCRIPTION
  655.             "The number of times this port has transitioned
  656.             from the Learning state to the Forwarding state."
  657.     ::= { dot1dStpPortEntry 10 }
  658.  
  659. -- the dot1dTp group
  660.  
  661. -- Implementation of the dot1dTp group is optional.  It is
  662. -- implemented by those bridges that support the transparent
  663. -- bridging mode.  A transparent or SRT bridge will implement
  664. -- this group.
  665.  
  666. dot1dTpLearnedEntryDiscards OBJECT-TYPE
  667.     SYNTAX  Counter
  668.  
  669.     ACCESS  read-only
  670.     STATUS  mandatory
  671.     DESCRIPTION
  672.             "The total number of Forwarding Database entries,
  673.             which have been or would have been learnt, but
  674.             have been discarded due to a lack of space to
  675.             store them in the Forwarding Database.  If this
  676.             counter is increasing, it indicates that the
  677.             Forwarding Database is regularly becoming full (a
  678.             condition which has unpleasant performance effects
  679.             on the subnetwork).  If this counter has a
  680.             significant value but is not presently increasing,
  681.             it indicates that the problem has been occurring
  682.             but is not persistent."
  683.     REFERENCE
  684.             "IEEE 802.1D-1990: Section 6.7.1.1.3"
  685.     ::= { dot1dTp 1 }
  686.  
  687. dot1dTpAgingTime OBJECT-TYPE
  688.     SYNTAX   INTEGER (10..1000000)
  689.     ACCESS   read-write
  690.     STATUS   mandatory
  691.     DESCRIPTION
  692.             "The timeout period in seconds for aging out
  693.             dynamically learned forwarding information.
  694.             802.1D-1990 recommends a default of 300 seconds."
  695.     REFERENCE
  696.             "IEEE 802.1D-1990: Section 6.7.1.1.3"
  697.     ::= { dot1dTp 2 }
  698.  
  699. --  The Forwarding Database for Transparent Bridges
  700.  
  701. dot1dTpFdbTable OBJECT-TYPE
  702.     SYNTAX  SEQUENCE OF Dot1dTpFdbEntry
  703.     ACCESS  not-accessible
  704.     STATUS  mandatory
  705.     DESCRIPTION
  706.             "A table that contains information about unicast
  707.             entries for which the bridge has forwarding and/or
  708.             filtering information.  This information is used
  709.             by the transparent bridging function in
  710.             determining how to propagate a received frame."
  711.     ::= { dot1dTp 3 }
  712.  
  713. dot1dTpFdbEntry OBJECT-TYPE
  714.     SYNTAX  Dot1dTpFdbEntry
  715.     ACCESS  not-accessible
  716.     STATUS  mandatory
  717.     DESCRIPTION
  718.             "Information about a specific unicast MAC address
  719.             for which the bridge has some forwarding and/or
  720.             filtering information."
  721.     INDEX   { dot1dTpFdbAddress }
  722.     ::= { dot1dTpFdbTable 1 }
  723.  
  724. Dot1dTpFdbEntry ::=
  725.     SEQUENCE {
  726.         dot1dTpFdbAddress
  727.             MacAddress,
  728.         dot1dTpFdbPort
  729.             INTEGER,
  730.         dot1dTpFdbStatus
  731.             INTEGER
  732.     }
  733.  
  734. dot1dTpFdbAddress OBJECT-TYPE
  735.     SYNTAX  MacAddress
  736.     ACCESS  read-only
  737.     STATUS  mandatory
  738.     DESCRIPTION
  739.             "A unicast MAC address for which the bridge has
  740.             forwarding and/or filtering information."
  741.     REFERENCE
  742.             "IEEE 802.1D-1990: Section 3.9.1, 3.9.2"
  743.     ::= { dot1dTpFdbEntry 1 }
  744.  
  745. dot1dTpFdbPort OBJECT-TYPE
  746.     SYNTAX  INTEGER
  747.     ACCESS  read-only
  748.     STATUS  mandatory
  749.     DESCRIPTION
  750.             "Either the value '0', or the port number of the
  751.             port on which a frame having a source address
  752.             equal to the value of the corresponding instance
  753.             of dot1dTpFdbAddress has been seen.  A value of
  754.             '0' indicates that the port number has not been
  755.             learned but that the bridge does have some
  756.             forwarding/filtering information about this
  757.             address (e.g. in the dot1dStaticTable).
  758.             Implementors are encouraged to assign the port
  759.             value to this object whenever it is learned even
  760.             for addresses for which the corresponding value of
  761.             dot1dTpFdbStatus is not learned(3)."
  762.     ::= { dot1dTpFdbEntry 2 }
  763.  
  764. dot1dTpFdbStatus OBJECT-TYPE
  765.     SYNTAX  INTEGER {
  766.                 other(1),
  767.                 invalid(2),
  768.                 learned(3),
  769.                 self(4),
  770.                 mgmt(5)
  771.             }
  772.     ACCESS  read-only
  773.     STATUS  mandatory
  774.     DESCRIPTION
  775.             "The status of this entry.  The meanings of the
  776.             values are:
  777.               other(1)   : none of the following.  This would
  778.                            include the case where some other
  779.                            MIB object (not the corresponding
  780.                            instance of dot1dTpFdbPort, nor an
  781.                            entry in the dot1dStaticTable) is
  782.                            being used to determine if and how
  783.                            frames addressed to the value of
  784.                            the corresponding instance of
  785.                            dot1dTpFdbAddress are being
  786.                            forwarded.
  787.               invalid(2) : this entry is not longer valid
  788.                            (e.g., it was learned but has since
  789.                            aged-out), but has not yet been
  790.                            flushed from the table.
  791.               learned(3) : the value of the corresponding
  792.                            instance of dot1dTpFdbPort was
  793.                            learned, and is being used.
  794.               self(4)    : the value of the corresponding
  795.                            instance of dot1dTpFdbAddress
  796.                            represents one of the bridge's
  797.                            addresses.  The corresponding
  798.                            instance of dot1dTpFdbPort
  799.                            indicates which of the bridge's
  800.                            ports has this address.
  801.               mgmt(5)    : the value of the corresponding
  802.                            instance of dot1dTpFdbAddress is
  803.                            also the value of an existing
  804.                            instance of dot1dStaticAddress."
  805.     ::= { dot1dTpFdbEntry 3 }
  806.  
  807. --  Port Table for Transparent Bridges
  808.  
  809. dot1dTpPortTable OBJECT-TYPE
  810.     SYNTAX  SEQUENCE OF Dot1dTpPortEntry
  811.     ACCESS  not-accessible
  812.     STATUS  mandatory
  813.     DESCRIPTION
  814.             "A table that contains information about every
  815.             port that is associated with this transparent
  816.             bridge."
  817.     ::= { dot1dTp 4 }
  818.  
  819. dot1dTpPortEntry OBJECT-TYPE
  820.     SYNTAX  Dot1dTpPortEntry
  821.     ACCESS  not-accessible
  822.     STATUS  mandatory
  823.     DESCRIPTION
  824.             "A list of information for each port of a
  825.             transparent bridge."
  826.     INDEX   { dot1dTpPort }
  827.     ::= { dot1dTpPortTable 1 }
  828.  
  829. Dot1dTpPortEntry ::=
  830.     SEQUENCE {
  831.         dot1dTpPort
  832.             INTEGER,
  833.         dot1dTpPortMaxInfo
  834.             INTEGER,
  835.         dot1dTpPortInFrames
  836.             Counter,
  837.         dot1dTpPortOutFrames
  838.             Counter,
  839.         dot1dTpPortInDiscards
  840.             Counter
  841.     }
  842.  
  843. dot1dTpPort OBJECT-TYPE
  844.     SYNTAX  INTEGER (1..65535)
  845.     ACCESS  read-only
  846.     STATUS  mandatory
  847.     DESCRIPTION
  848.             "The port number of the port for which this entry
  849.             contains Transparent bridging management
  850.             information."
  851.     ::= { dot1dTpPortEntry 1 }
  852.  
  853. -- It would be nice if we could use ifMtu as the size of the
  854. -- largest INFO field, but we can't because ifMtu is defined
  855. -- to be the size that the (inter-)network layer can use which
  856. -- can differ from the MAC layer (especially if several layers
  857. -- of encapsulation are used).
  858.  
  859. dot1dTpPortMaxInfo OBJECT-TYPE
  860.     SYNTAX  INTEGER
  861.     ACCESS  read-only
  862.     STATUS  mandatory
  863.     DESCRIPTION
  864.             "The maximum size of the INFO (non-MAC) field that
  865.             this port will receive or transmit."
  866.     ::= { dot1dTpPortEntry 2 }
  867.  
  868. dot1dTpPortInFrames OBJECT-TYPE
  869.     SYNTAX  Counter
  870.     ACCESS  read-only
  871.     STATUS  mandatory
  872.     DESCRIPTION
  873.             "The number of frames that have been received by
  874.             this port from its segment. Note that a frame
  875.             received on the interface corresponding to this
  876.             port is only counted by this object if and only if
  877.             it is for a protocol being processed by the local
  878.             bridging function, including bridge management
  879.             frames."
  880.     REFERENCE
  881.             "IEEE 802.1D-1990: Section 6.6.1.1.3"
  882.     ::= { dot1dTpPortEntry 3 }
  883.  
  884. dot1dTpPortOutFrames OBJECT-TYPE
  885.     SYNTAX  Counter
  886.     ACCESS  read-only
  887.     STATUS  mandatory
  888.     DESCRIPTION
  889.             "The number of frames that have been transmitted
  890.             by this port to its segment.  Note that a frame
  891.             transmitted on the interface corresponding to this
  892.             port is only counted by this object if and only if
  893.             it is for a protocol being processed by the local
  894.             bridging function, including bridge management
  895.             frames."
  896.     REFERENCE
  897.             "IEEE 802.1D-1990: Section 6.6.1.1.3"
  898.     ::= { dot1dTpPortEntry 4 }
  899.  
  900. dot1dTpPortInDiscards OBJECT-TYPE
  901.     SYNTAX   Counter
  902.     ACCESS   read-only
  903.     STATUS   mandatory
  904.     DESCRIPTION
  905.             "Count of valid frames received which were
  906.             discarded (i.e., filtered) by the Forwarding
  907.             Process."
  908.     REFERENCE
  909.             "IEEE 802.1D-1990: Section 6.6.1.1.3"
  910.     ::= { dot1dTpPortEntry 5 }
  911. -- The Static (Destination-Address Filtering) Database
  912.  
  913. -- Implementation of this group is optional.
  914.  
  915. dot1dStaticTable OBJECT-TYPE
  916.     SYNTAX  SEQUENCE OF Dot1dStaticEntry
  917.     ACCESS  not-accessible
  918.     STATUS  mandatory
  919.     DESCRIPTION
  920.             "A table containing filtering information
  921.             configured into the bridge by (local or network)
  922.             management specifying the set of ports to which
  923.             frames received from specific ports and containing
  924.             specific destination addresses are allowed to be
  925.             forwarded.  The value of zero in this table as the
  926.             port number from which frames with a specific
  927.             destination address are received, is used to
  928.             specify all ports for which there is no specific
  929.             entry in this table for that particular
  930.             destination address.  Entries are valid for
  931.             unicast and for group/broadcast addresses."
  932.     REFERENCE
  933.             "IEEE 802.1D-1990: Section 6.7.2"
  934.     ::= { dot1dStatic 1 }
  935.  
  936. dot1dStaticEntry OBJECT-TYPE
  937.     SYNTAX  Dot1dStaticEntry
  938.     ACCESS  not-accessible
  939.     STATUS  mandatory
  940.     DESCRIPTION
  941.             "Filtering information configured into the bridge
  942.             by (local or network) management specifying the
  943.             set of ports to which frames received from a
  944.             specific port and containing a specific
  945.             destination address are allowed to be forwarded."
  946.     REFERENCE
  947.             "IEEE 802.1D-1990: Section 6.7.2"
  948.     INDEX   { dot1dStaticAddress, dot1dStaticReceivePort }
  949.     ::= { dot1dStaticTable 1 }
  950.  
  951. Dot1dStaticEntry ::=
  952.     SEQUENCE {
  953.         dot1dStaticAddress
  954.             MacAddress,
  955.         dot1dStaticReceivePort
  956.             INTEGER,
  957.         dot1dStaticAllowedToGoTo
  958.             OCTET STRING,
  959.         dot1dStaticStatus
  960.             INTEGER
  961.     }
  962.  
  963. dot1dStaticAddress OBJECT-TYPE
  964.     SYNTAX  MacAddress
  965.     ACCESS  read-write
  966.     STATUS  mandatory
  967.     DESCRIPTION
  968.             "The destination MAC address in a frame to which
  969.             this entry's filtering information applies.  This
  970.             object can take the value of a unicast address, a
  971.             group address or the broadcast address."
  972.     REFERENCE
  973.             "IEEE 802.1D-1990: Section 3.9.1, 3.9.2"
  974.     ::= { dot1dStaticEntry 1 }
  975.  
  976. dot1dStaticReceivePort OBJECT-TYPE
  977.     SYNTAX  INTEGER
  978.     ACCESS  read-write
  979.     STATUS  mandatory
  980.     DESCRIPTION
  981.             "Either the value '0', or the port number of the
  982.             port from which a frame must be received in order
  983.             for this entry's filtering information to apply.
  984.             A value of zero indicates that this entry applies
  985.             on all ports of the bridge for which there is no
  986.             other applicable entry."
  987.     ::= { dot1dStaticEntry 2 }
  988.  
  989. dot1dStaticAllowedToGoTo OBJECT-TYPE
  990.     SYNTAX  OCTET STRING
  991.     ACCESS  read-write
  992.     STATUS  mandatory
  993.     DESCRIPTION
  994.             "The set of ports to which frames received from a
  995.             specific port and destined for a specific MAC
  996.  
  997.             address, are allowed to be forwarded.  Each octet
  998.             within the value of this object specifies a set of
  999.             eight ports, with the first octet specifying ports
  1000.             1 through 8, the second octet specifying ports 9
  1001.             through 16, etc.  Within each octet, the most
  1002.             significant bit represents the lowest numbered
  1003.             port, and the least significant bit represents the
  1004.             highest numbered port.  Thus, each port of the
  1005.             bridge is represented by a single bit within the
  1006.             value of this object.  If that bit has a value of
  1007.             '1' then that port is included in the set of
  1008.             ports; the port is not included if its bit has a
  1009.             value of '0'.  (Note that the setting of the bit
  1010.             corresponding to the port from which a frame is
  1011.             received is irrelevant.)  The default value of
  1012.             this object is a string of ones of appropriate
  1013.             length."
  1014.     ::= { dot1dStaticEntry 3 }
  1015.  
  1016. dot1dStaticStatus OBJECT-TYPE
  1017.     SYNTAX  INTEGER {
  1018.                 other(1),
  1019.                 invalid(2),
  1020.                 permanent(3),
  1021.                 deleteOnReset(4),
  1022.                 deleteOnTimeout(5)
  1023.             }
  1024.     ACCESS  read-write
  1025.     STATUS  mandatory
  1026.     DESCRIPTION
  1027.             "This object indicates the status of this entry.
  1028.             The default value is permanent(3).
  1029.                  other(1) - this entry is currently in use but
  1030.                       the conditions under which it will
  1031.                       remain so are different from each of the
  1032.                       following values.
  1033.                  invalid(2) - writing this value to the object
  1034.                       removes the corresponding entry.
  1035.                  permanent(3) - this entry is currently in use
  1036.                       and will remain so after the next reset
  1037.                       of the bridge.
  1038.                  deleteOnReset(4) - this entry is currently in
  1039.                       use and will remain so until the next
  1040.                       reset of the bridge.
  1041.                  deleteOnTimeout(5) - this entry is currently
  1042.                       in use and will remain so until it is
  1043.                       aged out."
  1044.  
  1045.     ::= { dot1dStaticEntry 4 }
  1046.  
  1047. -- Traps for use by Bridges
  1048.  
  1049. -- Traps for the Spanning Tree Protocol
  1050.  
  1051. newRoot TRAP-TYPE
  1052.     ENTERPRISE  dot1dBridge
  1053.     DESCRIPTION
  1054.             "The newRoot trap indicates that the sending agent
  1055.             has become the new root of the Spanning Tree; the
  1056.             trap is sent by a bridge soon after its election
  1057.             as the new root, e.g., upon expiration of the
  1058.             Topology Change Timer immediately subsequent to
  1059.             its election.  Implementation of this trap is
  1060.             optional."
  1061.     ::= 1
  1062.  
  1063. topologyChange TRAP-TYPE
  1064.     ENTERPRISE  dot1dBridge
  1065.     DESCRIPTION
  1066.             "A topologyChange trap is sent by a bridge when
  1067.             any of its configured ports transitions from the
  1068.             Learning state to the Forwarding state, or from
  1069.             the Forwarding state to the Blocking state.  The
  1070.             trap is not sent if a newRoot trap is sent for the
  1071.             same transition.  Implementation of this trap is
  1072.             optional."
  1073.     ::= 2
  1074.  
  1075. END
  1076.